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1  Introduction 


The  primary  motivation  to  design  a  new  GUI  (graphical  user  interface)  for  MGED  was  to  take 
advantage  of  XT  (X  Toolkit)  and  the  look  and  feel  of  the  widget  sets  that  are  layered  above  that.  In 
particular,  the  X  display  manager  has  been  rewritten  to  make  use  of  the  Motif^  widget  set.  The  usual 
assortment  of  display  managers  are  still  available;  however,  this  document  concerns  itself  primarily 
with  the  X  display  manager.  Any  deviation  from  this  will  be  noted. 

In  addition  to  modernizing  the  GUI,  many  new  features  have  also  been  added.  Among  these 
are  command  history  and  editing,  command  aliasing,  journaling  and  script  files,  multiple  views, 
multiple  drawing  windows,  online  documentation,  alternate  mouse  modes,  position  (in  addition  to 
rate)  based  sliders/knobs,  viewing  axes,  binding  of  keys  and  mouse  buttons,  support  for  dials  and 
buttons,  user  defined  menus,  color  support,  etc.  Figure  1  depicts  XMGED  with  an  assortment  of 
utility  windows  displayed. 


Figure  1:  Utility  Windows 


Many  new  commands  and  buttons  have  been  added.  The  buttons  pertain  only  to  the  X  display 
manager,  while  the  new  commands  have  been  designed  to  work  with  all  display  managers.  However, 
in  the  case  where  the  command  is  inherently  display  manager  dependent,  hooks  have  been  provided 
to  allow  support  for  a  particular  display  manager.  In  commands  of  this  type,  no  support  has  yet 
been  added  for  other  display  managers,  so  the  command  simply  returns.  Too  add  support  for  a 
particular  display  manager,  one  would  need  to  write  a  new  function  within  that  display  manager, 
declare  the  appropriate  hook,  and  initialize  the  hook  to  point  to  the  newly  created  function.  One 
would  also  have  to  set  these  hooks  to  null  when  releasing  the  display. 


^  Motif  is  a  trademark  of  tke  Open  Software  Foundation,  Inc. 


The  new  X  display  manager  is  more  than  just  a  replacement  for  the  old  X  display  manager.  It 
can  also  be  considered  as  a  replacement  for  the  Sgi  display  manager  because  when  running  on  an 
Sgi,  the  drawing  is  done  in  GL  (Sgi’s  Graphics  Library).  As  with  the  Sgi  display  manager,  access  to 
the  dials  and  buttons  is  also  provided.  It  should  be  noted  that  the  customary  Sgi  display  manager 
is  still  available. 

For  convenience,  listed  at  the  end  of  this  document  are  the  startup  defaults,  a  list  of  the  supported 
keysyms,  a  sample  source  file,  pertinent  X  resource  names,  and  the  fallback  X  resources. 

2  About  This  Release 

Source  code  for  XMGED  is  included  with  BRL-CAD  release  4.3  or  later.  You  will  need  a  machine 
with  XI 1  and  the  Motif  widget  set.  All  Sgi  machines  come  with  Motif.  On  Suns  and  other  machines, 
this  may  be  an  extra  cost  option.  If  there  is  enough  interest,  a  version  using  a  public  domain  widget 
set  will  be  developed. 


3  Getting  Started 

3.1  Single  Display 

Here  is  an  example  of  starting  XMGED  in  its  single  window  mode. 

•/,  xmged  file.g 

BRL-CAD  Release  4.3  Graphics  Editor  (MGED) 

Fri  Jan  14  17:13:46  ESI  1994,  Compilation  12 
bparkerSadmii : /scivis/phil/ cad4 . 3/ . xmged . 5d 

attach  (nu I tek I tek4109 I ps I  plot  I sgi I X) [nu] ?  X 
X  Display (User  Interface)  [:0.0]? 

X  Display (Drawing  Area  0)  [:0.0]? 

X  Display (Drawing  Area  1) 

ATTACHING  X  (X  Window  System  (Xll)) 

You  should  attach  to  the  “X”  interface.  Even  if  you  are  on  an  Sgi,  “X’’  must  be  selected  to  get 
the  new  interface.  The  code  will  automatically  sense  that  you  are  using  an  Sgi  and  use  the  fast  GL 
graphics  routines  for  the  drawing  area. 

You  are  given  the  option  of  entering  several  X  DISPLAY  strings.  The  first  is  where  you  would 
like  the  user  interface  to  be  displayed,  i.e.,  the  part  with  the  buttons,  menus,  command  window,  etc. 
The  second  prompt  (for  Drawing  Area  0)  allows  you  to  specify  a  different  location  for  the  drawing 
area.  If  the  specified  string  is  identical  to  that  for  the  user  interface,  you  will  get  the  combined  form, 
i.e,,  the  drawing  area  will  be  embedded  into  the  user  interface  as  seen  in  Figure  2.  If  these  displays 
differ,  the  drawing  area  will  be  placed  into  a  separate  window. 

Finally  it  prompts  you  for  an  optional  Drawing  Area  1.  If  a  DISPLAY  specification  is  entered 
here,  XMGED  will  open  a  second  drawing  area.  It  will  continue  to  prompt  for  additional  drawing 
areas  until  an  empty  line  (return)  is  entered.  In  this  way,  you  can  open  up  any  number  of  drawing 
areas  on  any  number  of  X  servers. 

3.2  Separate  Drawing  Area 

Here  is  an  example  of  starting  XMGED  with  the  user  interface  on  a  separate  machine  from  the 
drawing  area.  The  advantage  of  this  is  that  you  can  dedicate  an  entire  display  to  the  drawing  area 
and  get  a  large  command  window  on  the  user  interface  machine  as  seen  in  Figure  3. 
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Figure  2;  Cobmined  User  Interface 
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Figure  3:  Separate  User  interface 


•/•  xmged  file.g 

BRL-CAD  Release  4.3  Graphics  Editor  (MGED) 

Fri  Jam  14  17:13:46  ESI  1994,  Compilation  12 
bparkerOadmii : /scivis/phil/cad4 . 3/ . xmged . 6d 

attach  (iiu|tek|tek4109|ps|plot  IsgilX)  [nil]?  X 
X  Display (User  Interface)  [:0.0]?  remotehost:0 
X  Display (Drawing  Area  0)  [:0.0]? 

X  Display(Drawing  Area  1) 

ATTACHING  X  (X  Window  System  (Xll)) 

When  the  user  interface  and  drawing  areas  are  to  be  displayed  on  different  X  servers,  it  is 
recommended  that  the  drawing  area  be  made  local  (i.e.,  on  the  machine  running  XMGED)  while 
the  user  interface  is  made  remote.  This  is  because  bandwidth  to  the  drawing  area  is  much  more 
important  than  to  the  user  interface. 

In  all  cases  of  separate  or  multiple  drawing  areas,  mouse  input  is  active  in  all  of  them,  but  mouse 
input  normally  required  in  the  drawing  area,  e.g.,  to  center  or  resize  the  view,  can  be  directed  to 
an  ^‘input  window”  on  the  user  interface  machine  instead.  This  input  window  is  selected  from  the 
main  menu. 


4  Startup  File 

4.1  General  Information 

A  startup  file  exists  that  is  associated  with  the  X  display  manager.  The  XMGEDRC  environment 
variable  defines  this  file  which  is  read  in  during  the  initialization  process.  If  this  is  not  defined,  or 
the  startup  file  is  not  found,  the  current  directory  is  searched  for  the  file  .xmgedrc.  If  this  file  is  not 
found,  it  is  searched  for  in  the  user’s  home  directory.  See  a  list  of  the  startup  defaults  in  section  A. 

The  startup  file  provides  for  the  specification  of  menus,  key  bindings,  mouse  button  bindings, 
dial  bindings,  and  button  box  bindings.  The  contents  of  each  specification  is  enclosed  within  curly 
braces.  All  of  the  specifications  begin  with  a  keyword.  In  the  case  of  a  menu  specification,  the 
keyword  is  followed  by  a  string.  A  string  is  defined  as  a  series  of  one  or  more  characters  surrounded 
by  double  quotes.  The  body  of  the  string  starts  out  with  an  optional  exclamation  point  followed 
by  a  letter.  The  rest  of  the  string  can  be  any  character  except  a  double  quote  or  a  newline.  The 
following  regular  expression  more  succinctly  defines  the  set  of  allowable  strings. 

!?Ca-zA“Z] C*\»\n]* 


4.2  User  Menus 

The  menu  specification  is  similar  to  that  found  in  a  .twmrc  file.  A  menu  can  be  defined  anywhere 
and  in  any  order  within  the  startup  file.  Figure  4  shows  a  generalized  menu  specification.  There  are 
five  keywords  associated  with  a  menu  specification.  They  are  menu,  fAiile,  /.separator,  /menu,  and 
/exec.  The  menu  keyword  is  used  to  begin  the  definition  and  is  followed  by  a  string  that  names  the 
menu.  The  other  keywords  are  functions/actions.  F.iiile  creates  a  title  in  the  menu.  F. separator 
places  a  line  in  the  menu.  F.exec  and  the  M’  character  are  both  followed  by  a  shell  command  that 
is  executed  when  selected.  And  finally,  /  menu  references  a  submenu  and  is  followed  by  the  name  of 
the  submenu. 

Submenus  can  be  used  in  more  than  one  menu.  It  should  be  noted  that  submenus  can  also  have 
submenus  and  that  there  is  no  software  limit  within  XMGED  to  how  deep  they  can  go.  However, 
if  an  infinite  loop  is  detected,  the  corresponding  menu  button  will  be  made  insensitive.  Top  level 
menus  are  menus  that  are  not  referenced  within  another  menu.  They  will  be  given  buttons  in  the 
menu  bar  and  will  be  labeled  with  the  menu  name. 
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menu  string 

{ 

string  I  actioni 
stringn  actioun 

} 


Figure  4:  General  Menu  Specification 


The  contents  of  the  menu  consist  of  two  columns  of  information.  The  first  column  contains  the 
button  labels,  while  the  second  contains  a  specification  of  some  action  to  be  taken.  The  action  is 
either  a  function  keyword  possibly  followed  by  a  string,  or  an  optional  followed  by  a  string.  If 
a  string  is  specified  by  itself  in  the  right  column,  it  is  interpreted  by  XMGED.  Figure  5  shows  two 
sample  menus. 


menu  "main" 

{ 

"The  Main  Menu" 

M  M 

"another  menu" 
"shell  Is" 
"shell  Is" 

"mged  Is" 

} 


f .title 
1 .separator 
f.menu  "menul" 
f.exec  "Is" 
!"ls" 

"Is" 


menu  "menul" 

{ 

"user  defined  command"  "buildtank" 
"exit"  "q" 

} 


Figure  5:  Sample  Menu 

In  Figure  5,  main  is  a  top  level  menu,  while  menul  is  a  submenu.  Main  illustrates  the  different 
kinds  of  menu  items  that  can  be  created  and  will  be  given  a  button  labeled  main  in  the  menu  bar. 

4.3  Key  Binding 

A  key  can  be  bound  to  an  arbitrary  command.  These  key  bindings  take  effect  only  within  a  drawing 
window  or  the  input  window.  That  is,  if  key  is  bound  to  the  command  zoom  0.5 ^  then  pressing  .a: 
while  in  the  drawing  window  will  execute  zoom  0.5. 

The  keyword  Keys  is  used  to  begin  the  specification  of  key  bindings.  Figure  6  shows  a  generalized 
key  binding  specification.  There  are  two  columns  of  information,  one  for  the  keysym  and  one  for  the 
command.  A  keysym  is  a  machine  independent  symbolic  representation  of  a  key.  See  section  B  for 
a  list  of  the  supported  keysyms.  Keys  can  also  be  bound  using  the  bindkey  command.  See  section 

8.3  for  a  description  of  bindkey.  Also  see  section  A  for  a  list  of  the  default  key  bindings. 
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Keys 

{ 


keysymi  stringi 
keysyrrin  stringn 

} 

Figure  6:  General  Key  Specification 

4.4  Mouse  Button  Binding 

The  keyword  Buttons  is  used  to  begin  the  specification  of  the  mouse  button  bindings.  Figure  7  shows 
a  generalized  mouse  button  binding  specification.  There  are  three  columns  of  information.  The  first 
of  which  specifies  the  mouse  button.  The  following  key  words  are  used  for  referencing  a  mouse  button: 
Buttonl,  Button2,  and  ButtonS.  The  last  two  columns  specify  the  mode  and  function. 


Buttons 


hutiorii 

model 

functiorii 

button^ 

moden 

funciioTin 

Figure  7:  General  Mouse  Button  Specification 


For  the  purpose  of  binding  mouse  buttons,  there  are  four  different  modes.  The  mouse  buttons 
can  be  bound  to  one  of  three  functions  for  each  mode.  Below  is  a  list  of  the  modes  along  with  three 
possible  functions  for  each. 


view 

inzoom,  outzoom,  slew 

alt 

translate,  rotate,  zoom 

swap 

getview,  putview,  swapview 

edit 

inzoom,  outzoom,  pick 

Each  of  these  is  also  a  keyword.  The  alt  mode  can  only  be  active  while  in  the  VIEW  state  or 
an  EDIT  state.  The  view  and  swap  modes  are  only  active  when  XMGED  is  in  the  VIEW  state. 
Otherwise,  the  edit  mode  bindings  take  effect.  See  section  A  for  a  list  of  the  default  mouse  button 
bindings. 


4.5  Dial  Binding 

The  dials  can  also  be  rebound.  The  Dials  keyword  begins  the  specification  of  the  dial  bindings.  Fig¬ 
ure  8  shows  a  generalized  dial  binding  specification.  There  are  two  or  three  columns  of  information. 
The  first  column  denotes  the  dial.  The  following  keywords  are  used  for  referencing  a  dial:  DialO, 
Diall,  . . .,  Dial!,  The  Shift  keyword,  if  used,  is  in  the  second  column  and  indicates  that  the  shift 
key  is  being  held  down.  The  last  column  is  reserved  for  the  function  specifier.  Table  1  shows  a  list 
of  function  specifiers  along  with  a  brief  description  of  each.  See  section  A  for  a  list  of  the  default 
dial  bindings. 
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Dials 

{ 


diali  [shift]  functioni 
dialn  [shift]  functiorin 

Figure  8:  General  Dial  Specification 


Table  1:  Dial  Keywords 


Function  Specifier 

Function  Description 

no  action 

XJOY 

X  rotation 

YJOY 

y  rotation 

ZJOY 

z  rotation 

XSLEW 

X  translation 

YSLEW 

y  translation 

ZSLEW 

z  translation 

ZOOM 

zoom  view  in  or  out 

ADCl 

rotate  angle  1 

ADC2 

rotate  angle  2 

ADCX 

X  translation  of  angle  distance 
cursor 

ADCY 

y  translation  of  angle  distance 
cursor 

ADCDIST 

move  tick  marks 
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4.6  Button  Box  Binding 

A  button  box  button  can  be  bound  to  an  arbitrary  command.  The  BBox  keyword  begins  the  button 
box  bindings  specification.  Figure  9  shows  a  generalized  button  box  binding  specification.  There 
are  two  columns  of  information.  The  first  refers  to  the  button.  The  following  keywords  are  used  for 
referencing  a  button:  Buiionl,  Buiion2,  . . , ,  Buiion32.  The  second  column  indicates  the  command. 
See  section  A  for  a  list  of  the  default  button  box  bindings. 


BBox 

{ 

buttoTii  stringi 
buitoTin  stringn 

} 


Figure  9:  General  Button  Box  Specification 


5  Multiple  Drawing  Areas 

Any  number  of  drawing  areas  can  be  opened  for  drawing.  This  feature  was  created  in  order  to  display 
copies  of  the  drawing  area  on  different  workstations  for  the  purpose  of  training,  or  for  collaboration 
with  colleagues.  Input  events  such  as  buttonpress,  keypress,  and  pointer  motion,  can  be  captured  as 
usual  in  the  drawing  window(s)  or  remotely,  on  the  GUI  display,  using  the  input  window.  The  input 
window  is  active  only  if  the  GUI  is  not  combined  with  a  drawing  area.  The  GUI  and  drawing  area 
0  will  be  combined  if,  during  the  initial  prompting  for  display  names,  the  display  name  of  drawing 
area  0  is  the  same  as  the  display  name  of  the  GUI.  Figure  2  shows  the  combined  user  interface, 
while  Figure  3  shows  the  separated  user  interface.  If  running  XMGED  on  an  Sgi  and  displaying  on 
an  Sgi,  XMGED  will  open  a  GL  window  for  drawing,  otherwise  it  will  open  an  X  window.  If  the 
drawing  area  is  an  X  window  and  the  X  display  supports  color,  then  the  solids  will  be  drawn  in  a 
color  that  closely  matches  the  assigned  color. 


6  Multi-Views 

A  nev/  mode  called  multi-views  allows  four  different  views  to  be  displayed  at  one  time,  as  can  be 
seen  in  Figure  10.  The  default  views  shown  are  45,45,  front,  left  and  top.  Multi-views  mode  is 
toggled  on/off  by  clicking  the  button  labeled  multi  views  in  the  main  menu  or,  assuming  the  default 
key  bindings,  by  pressing  the  m  key  while  in  the  drawing  area. 

All  slider  operations  and  view-related  commands  entered  from  the  command  window  or  by  mak¬ 
ing  a  menu  selection  affect  only  the  lower  right  window  which  shares  its  view  with  the  main  window. 
The  views  in  each  of  the  windows,  other  than  the  lower  right  window,  can  only  be  changed  by  using 
the  mouse,  keyboard,  or  dials  and  buttons.  If  use  of  the  command  window,  menus,  or  sliders  are 
desired  to  manipulate  the  view  within  either  of  these  three  windows,  the  view  can  be  swapped  over 
to  the  lower  right  window.  This  can  be  done  while  in  swap  mode  or  by  using  control-n  or  control-p 
to  cycle  through  the  views.  When  in  the  drawing  window,  control-n  and  control-p  cause  the  view 
to  be  changed  to  the  next  or  previous  view  respectively,  and  will  work  whether  or  not  multi-views 
mode  is  active. 
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Figure  10:  Multiple  Views 


7  Command  Window 


There  is  a  text  window  associated  with  the  GUI  for  entering  commands.  This  window  has  command 
line  editing  capabilities  which  include  a  facility  for  accessing  previous  commands.  The  functionality 
is  similar  to  that  of  tcsh.  See  Table  2  for  a  list  of  the  features  that  have  been  implemented.  For 
more  information  on  command  history,  see  the  history  command  in  section  8.7. 


Table  2:  Command  Line  Editing 


Control  Sequence 

Function 

previous  command 

"n 

next  command 

-b 

backward  one  character 

forward  one  character 

"a 

beginning  of  line 

"e 

end  of  line 

*d 

delete  next  character 

*h 

delete  previous  character 

*w 

delete  previous  word 

-k 

delete  to  end  of  line 

*u 

delete  to  beginning  of  line 

Also  note  that  if  the  GUI  is  combined  with  a  drawing  area,  the  drawing  area  and  the  text  area 
are  placed  in  a  pane  widget.  This  provides  a  way  to  increase  or  decrease  the  size  of  the  text  area 
by  grabbing  the  pane  control  sash.  The  control  sash  is  the  small,  square  box  located  above  and  to 
the  right  of  the  text  window.  Figure  11  shows  the  combined  user  interface  with  the  pane  partially 
raised. 


8  New  Commands 

8.1  AIP 

aip  [fb] 

Aip  advances  the  illumination  pointer  either  forward  or  backward  while  in  a  pick  state.  If  the  current 
state  is  ST-O-PATH,  then  the  path  position  is  moved  either  forward  or  backward.  If  no  parameters 
are  given,  the  default  advancement  direction  is  forward.  This  command  was  created  for  the  purpose 
of  binding  to  a  key. 

8.2  ALIAS 

alias  Calias.name  [cominand(s)  pareoneterCs)]] 

This  command,  with  no  parameters,  prints  out  a  list  of  the  currently  defined  aliases  and  their 
definitions.  With  one  parameter,  it  prints  out  the  definition  of  alias jname.  Otherwise,  it  defines 
alias_name  to  be  that  specified  by  the  remainder  of  the  command  line.  Parameters  may  be  introduced 
by  using  $N  anywhere  in  the  definition.  For  example,  to  define  an  alias  to  make  an  arb8  using  the 
make  command,  enter  the  following: 

alias  m8  make  $1  arb8 

To  make  an  arb8  with  the  name  new_arb8,  the  following  command  can  now  be  entered: 
m8  new_arb8 

Multiple  commands  within  the  alias  definition  are  separated  with  semicolons.  For  example,  to 
define  another  alias  to  make  an  arb8,  solid  edit  the  new  arb  by  translating  it  to  a  new  location  and 
accept  the  edit,  enter  the  following: 
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Figure  11:  Partially  Raised  Window  Pane 


alias  mse8  m8  $1;  sed  $1;  press  stran;  p  $2  $3  $4;  press  accept 

To  make  an  arbS  called  moved_arb8  and  reposition  it  to  (10,  20,  30),  you  can  now  enter  the 
following: 

mse8  moved_arb8  10  20  30 

As  you  can  see,  the  use  of  aliases  within  another  alias  definition  is  allowed.  However,  recursive 
definitions  are  not  allowed.  For  example,  you  can  define  /  (alias  1  1  *)  to  list  object  information  for 
all  objects  in  the  database,  but  you  cannot  do  the  following: 

alias  mT  maike  $1  arbT 
alias  marbs  m7  $1;  in8  $2 
alias  m8  marbs  $1  $2 

The  semiexpanded  definition  of  m8  is: 

alias  m8  m7  $1;  m8  $2 

Now  if  you  enter  mS  a7  a8^  an  arb7  named  a7  is  created,  but  the  command,  m8  a8^  is  not 
recognized  because  the  alias  m8  has  already  been  touched,  so  no  substitution  is  made.  That  is,  the 
command  m8  a8  is  executed  as  is,  which  of  course  fails  because  it  is  not  a  valid  MGED  command. 

8.3  BINDKEY 

bindkey  [key  [command]] 

Bindkey  causes  a  key  to  be  bound  to  a  command.  However,  if  only  the  key  parameter  is  given, 
bindkey  prints  out  the  current  key  binding.  If  no  parameters  are  given,  then  a  list  of  all  the  current 
key  bindings  is  printed.  The  key  parameter  is  a  keysym  with  the  preceding  XK.  stripped  off.  See 
section  B  for  a  list  of  the  supported  keysyms. 

8.4  BUTTON 

button  number 

This  command  simulates  a  button  press  and  is  intended  to  be  used  by  XMGED  when  journalling. 
Number  refers  to  a  particular  button.  The  following  is  a  list  of  button  numbers: 

DESCRIPTION _ NUMBER  DESCRIPTION  NUMBER 

arb4  move  point  1 
arb4  move  point  2 
arb4  move  point  3 
arb4  move  point  4 
arb4  move  face  123 
arb4  move  face  124 
arb4  move  face  234 
arb4  move  face  134 
arb4  rotate  face  123 
arb4  rotate  face  124 
arb4  rotate  face  234 
arb4  rotate  face  134 

arb5  move  edge  12 
arb5  move  edge  23 
arb5  move  edge  34 


0 

ellipse  scale  A 

97 

1 

ellipse  scale  B 

98 

2 

ellipse  scale  C 

99 

3 

ellipse  scale  A,B,C 

100 

4 

5 

tgc  scale  H 

101 

6 

tgc  scale  A 

102 

7 

tgc  scaleB 

103 

8 

tgc  scale  C 

104 

9 

tgc  scale  D 

105 

10 

tgc  scale  A,B 

106 

11 

tgc  scaleC,D 

107 

tgc  scale  A,B,C,D 

108 

12 

tgc  rotate  H 

109 

13 

tgc  rotate  AXB 

110 

14 

tgc  move  end  H(rt) 

111 

13 


arbS  move  edge  14 

15 

tgc  move  end  H 

112 

arb5  move  edge  15 

16 

arb5  move  edge  25 

17 

eto  scale  R 

113 

arb5  move  edge  35 

18 

eto  scale  D 

114 

arb5  move  edge  45 

19 

eto  scale  C 

115 

arb5  move  point  5 

20 

eto  rotate  C 

116 

arb5  move  face  1234 

21 

arb5  move  face  125 

22 

rpc  scale  B 

117 

arb5  move  face  235 

23 

rpc  scale  H 

118 

arb5  move  face  345 

24 

rpc  scale  R 

119 

arb5  move  face  145 

25 

arb5  rotate  face  1234 

26 

rch  scale  B 

120 

arb5  rotate  face  125 

27 

rch  scale  H 

121 

arb5  rotate  face  235 

28 

rch  scale  R 

122 

arb5  rotate  face  345 

29 

rch  scale  C 

123 

arbS  rotate  face  145 

30 

epa  scale  H 

124 

arb6  move  edge  12 

31 

epa  scale  A 

125 

arb6  move  edge  23 

32 

epa  scale  B 

126 

arb6  move  edge  34 

33 

arb6  move  edge  14 

34 

ehy  scale  H 

127 

arb6  move  edge  15 

35 

ehy  scale  A 

128 

arb6  move  edge  25 

36 

ehy  scale  B 

129 

arb6  move  edge  36 

37 

ehy  scale  C 

130 

arbS  move  edge  46 

38 

arb6  move  point  5 

39 

spline  pick  vertex 

131 

arb6  move  point  6 

40 

spline  move  vertex 

132 

arb6  move  face  1234 

41 

arb6  move  face  2365 

42 

rung  pick  edge 

133 

arb6  move  face  1564 

43 

rung  move  edge 

134 

arbS  move  face  125 

44 

rung  split  edge 

135 

arb6  move  face  346 

45 

rung  delete  edge 

136 

arb6  rotate  face  1234 

46 

rung  next  eu 

137 

arb6  rotate  face  2365 

47 

rung  prev  en 

138 

arb6  rotate  face  1564 

48 

rung  radial  eu 

139 

arb6  rotate  face  125 

49 

rung  extrude  loop 

140 

arb6  rotate  face  346 

50 

nmg  debug  edge 

141 

arb7  move  edge  12 

51 

object  scale 

142 

axb7  move  edge  23 

52 

object  X  move 

143 

arb7  move  edge  34 

53 

object  Y  move 

144 

arb7  move  edge  14 

54 

object  XY  move 

145 

arb7  move  edge  15 

55 

object  rotate 

146 

arb7  move  edge  26 

56 

object  scale  X 

147 

arb7  move  edge  56 

57 

object  scale  Y 

148 

arb7  move  edge  67 

58 

object  scale  Z 

149 

arb7  move  edge  37 

59 

arb7  move  edge  57 

60 

solid  rotate 

150 

arb7  move  edge  45 

61 

solid  translate 

151 

arb7  move  point  5 

62 

solid  scale 

152 

arb7  move  face  1234 

63 

arb7  move  face  2376 

64 

reject  edit 

153 

arb7  rotate  face  1234 

65 

accept  edit 

154 

arb7  rotate  face  567 

66 

save  edit 

155 

14 


arb7 

rotate  lace  145 

67 

arb7 

rotate  face  2376 

68 

top 

156 

arb7 

rotate  face  1265 

69 

bottom 

157 

arb7 

rotate  face  4375 

70 

right 

158 

left 

159 

arb8 

move  edge  12 

71 

front 

160 

arb8 

move  edge  23 

72 

rear 

161 

arb8 

move  edge  34 

73 

45,45 

162 

arb8 

move  edge  14 

74 

35,25 

163 

arb8 

move  edge  15 

75 

restore  view 

164 

CO 

move  edge  26 

76 

save  view 

165 

arb8 

move  edge  56 

77 

reset  view 

166 

arb8 

move  edge  67 

78 

sliders 

167 

arb8 

move  edge  78 

79 

zero  sliders 

168 

arb8 

move  edge  58 

80 

input  win 

169 

arb8 

move  edge  37 

81 

arb8 

move  edge  48 

82 

angdist  curs 

170 

arb8 

move  face  1234 

83 

solid  ilium 

171 

arb8 

move  face  5678 

84 

object  ilium 

172 

arb8 

move  face  1584 

85 

alt  mouse  mode 

173 

arb8 

move  face  2376 

86 

multi  views 

174 

arb8 

move  face  1265 

87 

swap  views 

175 

axb8 

move  face  4378 

88 

rate  based 

176 

arb8 

rotate  face  1234 

89 

arb8 

rotate  face  5678 

90 

help 

177 

arb8 

rotate  face  1584 

91 

Hged  database  file 

178 

arb8 

rotate  face  2376 

92 

Postscript  file 

179 

arb8 

rotate  face  1265 

93 

Pix  file 

180 

arb8 

rotate  face  4378 

94 

Open 

181 

Insert 

182 

torus  scale  radius  1 

95 

Show  Info 

183 

torus  scale  radius  2 

96 

Manual 

184 

Exit 

185 

8.5  CLOSEW 

closew  [host] 

Close  the  drawing  area  associated  with  host.  Host  must  be  in  the  same  format  as  would  the  DISPLAY 
environment  variable.  For  example,  host  could  be  someMachine:0.  If  the  GUI  is  combined  with  a 
drawing  area,  then  that  area  is  not  affected  by  this  command.  If  host  is  not  specified,  a  list  of  the 
currently  opened  drawing  areas  is  printed. 

8.6  CUE 

cue 

Toggle  depth  cuing  on/off.  This  command  was  created  for  the  purpose  of  binding  to  a  key. 

8.7  HISTORY 

history  [N] 

This  command  lists  all  of  the  previous  commands  or  the  last  N  commands  if  N  is  specified.  MGED 
currently  implements  a  subset  of  the  csh  history  list  recall  facility  with  one  caveat.  The  character 
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replaces  because  MGED  already  uses  to  execute  a  shell  command.  Table  3  lists  the 
implemented  features. 


Table  3:  Command  History 


Command 

Function 

@N 

execute  the  Nth  command 

@@ 

execute  the  last  command 

@-N 

execute  the  Nth  command  from  last  one 

@str 

execute  the  last  command  with  “str”  any¬ 

where  in  the  command  line 

8.8  IKNOB 

iknob  id  [val] 

Iknob  is  like  the  knob  command  except  that  val  is  used  to  incrementally  change  the  value  associated 
with  id.  This  command  was  created  for  the  purpose  of  binding  to  a  key. 

8.9  IROT 

irot  X  y  z 

Irot  is  used  to  incrementally  rotate  solids/objects  while  in  an  edit  state,  or  to  rotate  the  view  while 
in  a  nonedit  state.  The  values  of  x,  y,  and  2  represent  degrees  of  rotation.  This  command  was 
created  for  the  purpose  of  binding  to  a  key. 

8.10  ITRAN 

itran  x  y  z 

liran  is  used  to  incrementally  translate  solids/objects  while  in  an  edit  state,  or  to  slew  the  view  in 
a  nonedit  state.  The  values  of  x,  y,  and  2:  represent  increments  in  view  coordinates.  This  command 
was  created  for  the  purpose  of  binding  to  a  key. 

8.11  JOURNAL 

journal  [file] 

This  command  toggles  journalling.  When  journalling  is  on,  commands  are  written  to  file  which  can 
later  be  executed  via  the  source  command.  If  file  is  not  entered  on  the  command  line,  a  file  name 
is  chosen  for  you.  For  more  information,  see  a  description  of  the  MG  ED  .JOURNAL  environment 
variable  in  section  12.1. 

8.12  LIGHT 

light 

Toggle  lighting  on/off.  This  command  was  created  for  the  purpose  of  binding  to  a  key. 

8.13  OPENDB 

opendb  database 

Read  a  new  database  into  XMGED.  If  the  given  database  name  does  not  exist,  the  user  will  be 
prompted  to  create  a  new  database.  If  the  user  decides  not  to  create  a  new  database  and  no 
database  is  currently  open,  the  program  is  exited.  Otherwise,  the  previous  database  remains  loaded. 
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8.14  OPENW 

openw  [host] 

Open  a  drawing  area  on  host.  Host  must  be  in  the  same  format  as  the  DISPLAY  environment 
variable.  For  example,  host  could  be  someMachinerO.  If  host  is  not  specified,  a  list  of  the  currently 
opened  drawing  areas  is  printed. 

8.15  PS 

ps  [f]  file 

Creates  a  postscript  file  of  the  current  view.  If  the  /  option  is  given,  the  original  faceplate  is  also 
drawn. 

8.16  SAVEDIT 

savedit 

The  savedit  command  allows  the  user,  while  in  an  edit  state,  to  save  all  edits  and  remain  in  the  edit 
state.  To  continue  editing,  another  edit  option  must  be  selected. 

8.17  SLIDER 

slider  number  value 

This  command  simulates  a  slider  adjustment  and  is  intended  to  be  used  by  XMGED  when  jour¬ 
nalling.  The  number  refers  to  a  particular  slider  and  value  refers  to  the  slider’s  new  position.  The 
range  of  value  is  -1-/-100.  Table  4  shows  a  list  of  slider  numbers. 


Table  4:  Slider  Numbers 


Slider 

Number 

XSLEW/XTRAN 

0 

YSLEW/YTRAN 

1 

ZSLEW/ZTRAN 

2 

ZOOM 

3 

XROT 

4 

YROT 

5 

ZROT 

6 

XADC 

7 

YADC 

8 

ANGl 

9 

ANG2 

10 

TICK 

11 

8.18  SOURCE 

source  [beh]  commamd^file 

With  an  option  of  /i,  the  commands  in  command^file  are  added  to  the  history  list.  If  there  is  no 
option  or  an  option  of  e,  the  commands  are  executed.  If  the  option  is  the  commands  are  both 
executed  and  added  to  the  history  list.  See  a  description  of  the  MGEDJSRC-DIR  environment 
variable  in  section  12.2.  Also  see  a  sample  source  file  in  section  C. 
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8.19  SV 


sv  X  y 

This  command  moves  the  view  center  to  {x^  y,  0). 

8.20  TRAN 

trail  X  y  z 

Tran  is  used  to  translate  solids/objects  while  in  an  edit  state,  or  to  slew  the  view  in  a  nonedit  state. 
The  values  of  x,  y,  and  z  are  in  view  coordinates. 

8.21  UNALIAS 

unalias  def ined_alias 
This  command  undefines  the  defined^alias. 

8.22  ZBUFFER 

zbuffer 

Toggle  zbuffer  on/off.  This  command  was  created  for  the  purpose  of  binding  to  a  key. 

8.23  ZCLIP 

zclip 

Toggle  zclipping  on/off.  This  command  was  created  for  the  purpose  of  binding  to  a  key. 

9  Modified  Commands 

9.1  MATER 

The  maier  command  has  been  changed  to  handle  the  case  where  some  or  all  parameters  are  entered 
at  one  time  on  the  command  line.  The  parameters  are  positional,  so  if  some  are  missing,  the  user 
will  be  prompted  to  enter  them  in  as  before.  If  entering  rgb  values  via  the  command  line,  they  must 
all  be  entered  or  they  will  not  be  used.  The  del  parameter  may  also  be  used  on  the  command  line. 

9.2  PRESS 

The  press  command  has  been  changed  to  include  the  new  options  as  seen  in  Table  5.  These  options 
appear  somewhat  cryptic,  so  a  little  explanation  is  in  order. 

All  options  start  with  the  solid  type  and  are  followed  by  an  edit  description.  The  edit  description 
consists  of  the  type  of  edit  followed  by  the  part  to  be  edited.  For  non-arbs  and  non-nmgs,  the  first 
character  after  the  underscore  specifies  the  type  of  edit  and  is  either  an  m,  s,  or  r  that  stands  for 
move,  scale,  or  rotate  respectively.  For  arbs,  the  first  two  characters  after  the  underscore  designate 
the  type  of  edit.  Table  6  shows  a  list  of  the  arb  edit  specifiers  and  their  respective  meanings.  For 
nmgs,  the  first  two  or  three  characters  after  the  underscore  designate  the  type  of  edit.  Table  7  lists 
the  nmg  edit  specifiers  and  their  respective  meanings.  The  rest  of  the  option  is  used  to  describe 
the  part  of  the  solid  to  be  edited.  As  an  example,  epa^sb  represents  a  button  in  the  epa  solid  edit 
menu  that  says  scale  B,  And  igc^rh  represents  a  button  in  the  tgc  solid  edit  menu  that  says  rotate 
H.  While  a8jmel2  represents  a  button  in  the  arb8  solid  edit  menu  that  says  move  edge  12,  And 
a4-rfl24  represents  a  button  in  the  arb4  solid  edit  menu  that  says  rotate  face  124-  For  completeness. 
Table  8  lists  the  original  press  options. 
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Table  5:  New 

Press  Command  Options 

a8-mel2 

a8-me23 

a8-me34 

a8_mel4 

aSjTielS 

a8-me26 

a8-me56 

a8_me67 

a8-me78 

a8-jne58 

a8jTie37 

a8jne48 

a7-mel2 

a7-me23 

a7_me34 

a7-jnel4 

a7jTiel5 

a7-me26 

a7jiie56 

a7jiie67 

a7_me37 

a7-me57 

a7_me45 

a7_mp5 

a6_mel2 

a6_me23 

a6jTie34 

a6-jnel4 

a6jiiel5 

a6jnnie25 

a6_me36 

a6-me46 

a6_mp5 

ad-mpG 

a5-mel2 

a5jiie23 

a5-me34 

a5-mel4 

a5jnel5 

a5_me25 

a5_me35 

a5-me45 

a5_mp5 

a4_mpl 

a4jnp2 

a4_mp3 

a4jiip4 

tgcjsh 

tgcjsa 

tgc_sb 

tgCJSC 

tgcjsd 

tgc^ab 

tgcjscd 

tgc_sabcd 

tgc_rh 

tgc_raxb 

tgc_mh 

tgc_mhh 

tor-srl 

torjsr2 

etojsr 

etojsd 

etojsc 

eto.rc 

ell^a 

ell^b 

ell_sc 

ell_sabc 

ars 

spLpv 

spl_mv 

a8-mfl234 

a8_mf5678 

a8jTifl584 

a8-mf2376 

a8_mfl265 

a8-mf4378 

a7_mfl234 

a7_mf2376 

a6jnfl234 

a6jTif2365 

a6_mfl564 

a6jTifl25 

a6-Jiif346 

a5_mfl234 

a5-mfl25 

a5_mf235 

a5-mf345 

a5-infl45 

a4jTifl23 

a4_mfl24 

a4_mf234 

a4jiifl34 

a8-rfl234 

a8_rf5678 

a8-rfl584 

a8-rf2376 

a8j:fl265 

a8-rf4378 

a7jfl234 

a7-rf567 

a7_rfi45 

a7_rf2376 

a7j‘fl265 

a7j:f4375 

a6j‘fl234 

a6-rf2365 

a6-rfl564 

a6jrfl25 

a6-rf346 

a5j:fl234 

a5-rfl25 

a5j'f235 

a5-rf345 

a5jfl45 

a4_rfl23 

a4-rfl24 

a4j*f234 

a4_rfl34 

rpc_sb 

rpcjsh 

rpc-sr 

rhc-sb 

rhc_sh 

rhc-sr 

rhc_sc 

epajsh 

epa_sa 

epa_sb 

ehy_sh 

ehyjsa 

ehy_sb 

ehy_5c 

nmg-pe 

nmgjTie 

nmgjse 

nmg-del 

nmgmeu 

nmg_peu 

nmg_reu 

nmgjel 

nmg-de 

Table  6:  Arb  Edit  Specifiers 


Edit  Prefix 

Description 

mp 

move  point 

me 

move  edge 

mf 

move  face 

rf 

rotate  face 

Table  7:  NMG  Edit  Specifiers 


Edit  Prefix 

Description 

pe 

pick  edge 

me 

move  edge 

se 

split  edge 

del 

delete  edge 

neu 

next  edge  used 

pen 

previous  edge  used 

reu 

radial  edge  used 

el 

extrude  loop 

de 

debug  edge 
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Table  8:  Original  Press  Options 


35,25 

45,45 

accept 

adc 

bottom 

front 

left 

oill 

orot 

oscale 

ox 

oxy 

oxscale 

oy 

oyscale 

ozscale 

rear 

reject 

reset 

restore 

right 

save 

sedit 

sill 

slice 

srot 

sscale 

sxy 

stran 

top 

help 


9,3  SET 

The  set  command  has  been  changed  to  include  three  new  MGED  variables.  They  are  w^axis^  v.axisj 
and  e^axis.  These  variables  correspond  to  the  world  axis,  view  axis,  and  edit  axis,  respectively.  All 
of  these  variables  have  corresponding  X  resources  for  specifying  an  axis  color.  The  names  of  the 
resources  are  the  same  as  the  variable  names. 

The  world  axis  and  the  view  axis  can  be  viewed  anytime.  However,  the  edit  axis  can  only  be 
viewed  while  in  an  edit  state  as  seen  in  Figure  12.  If  the  value  of  any  of  the  variables  is  0,  the 
corresponding  axis  is  off.  Otherwise  it  is  on.  The  variable  v^axis  is  different  in  that  it  has  seven 
possible  settings.  Table  9  shows  a  list  of  these  settings.  Figure  13  shows  the  view  axis  in  the  center 
with  v^axis  =  1,  and  Figure  14  shows  the  view  axis  in  the  lower  left  with  v.axis  =  2. 


Figure  12:  Edit  Axis 
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Table  9:  View  Axis  Values 


State 

Location 

0 

off 

1 

center(full  size) 

2 

lower  left(half  size) 

3 

upper  left(half  size) 

4 

upper  right(half  size) 

5 

lower  right(half  size) 

6 

center(half  size) 

Figure  13:  View  Axis,  center 
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Figure  14:  View  Axis,  lower  left 
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10  New  Buttons 

10.1  SAVE  EDIT 

The  save  edit  button  allows  the  user,  while  in  either  the  solid  or  object  edit  state,  to  save  all  edits 
and  remain  in  the  respective  edit  state.  There  is  also  a  new  command  called  savedii.  Actually,  the 
save  edit  button  is  configured  to  call  the  savedii  command  when  activated. 

10.2  ALT  MOUSE  MODE 

The  alternative  mouse  mode  can  be  toggled  on/ofF  by  pressing  the  alt  mouse  mode  button.  This 
mode  offers  a  virtual  track  ball  style  rotation  and  a  grab  style  translation.  Assuming  the  default 
mouse  button  bindings,  while  in  the  VIEW  state,  the  left  button  is  used  for  a  translation,  the  middle 
button  is  used  for  rotation,  and  the  right  button  is  used  for  zoom/scale.  Zoom/scale  is  effected  by 
moving  the  cursor  vertically  while  pressing  the  right  mouse  button.  See  section  A  for  a  complete 
list  of  the  default  mouse  button  bindings. 

10.3  MULTI  VIEWS 

Pressing  the  multi  views  button  toggles  between  displaying  the  main  drawing  window  and  the  multi¬ 
views  window.  The  multi- views  window  shows  four  different  views  at  the  same  time.  The  default 
views  shown  are  45,45,  front,  left  and  top.  All  slider  operations  and  view-related  commands  affect 
only  the  lower  right  window  that  shares  its  view  with  the  main  window. 

10.4  SWAP  VIEWS 

The  swap  views  mode  can  be  toggled  on/offby  pressing  the  swap  views  button.  This  mode  is  useful 
only  when  in  multi  views  mode.  When  in  this  mode,  views  can  be  swapped  between  the  lower  right 
window  and  any  of  the  other  three.  For  instance,  assuming  the  default  mouse  button  bindings,  a 
left  button  press  in  any  window,  except  the  lower  right,  puts  that  windows  view  into  the  lower  right 
window.  A  middle  button  press  swaps  that  window’s  view  with  the  view  in  the  lower  right  window. 
And  a  right  button  press  puts  the  lower  right  window’s  view  into  the  window  where  the  button  press 
occurred.  However,  mouse  button  presses  in  the  lower  right  window  continue  to  function  unaffected 
by  swap  views  mode. 

10.5  INPUT  WIN 

Display  of  the  input  window  can  be  toggled  by  clicking  the  input  win  button.  However,  this  button 
becomes  insensitive  when  the  GUI  is  combined  with  a  drawing  area.  The  input  window  is  used  to 
capture  events  (buttonpress,  motion,  keypress,  etc.)  so  that  the  view  and  objects  can  be  manipulated 
remotely. 

10.6  RATE  BASED 

The  sliders,  as  well  as  the  knobs,  can  be  used  in  either  rate-based  or  positional  mode.  In  rate-based 
mode,  the  slider/knob  value  represents  a  rate  of  motion.  And  in  positional  mode,  the  slider/knob 
value  represents  a  nonrate-based  translation,  rotation,  or  zoom.  This  affords  the  user  another  mode 
of  control  over  view  change  and  object  movement.  Also,  when  in  positional  mode,  the  slider  labels 
for  xslew,  yslew,  and  zslew  change  to  xtran,  ytran,  and  ztran  respectively.  In  either  mode,  the  mouse 
is  still  able  to  manipulate  the  view  or  object(s). 

10.7  HELP 

Display  of  the  help  menu  can  be  toggled  on/off  by  clicking  the  help  button.  A  list  of  all  MGED 
commands  appears  in  the  menu.  To  see  a  description  of  a  command,  click  on  its  corresponding 
button. 
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11  The  FILE  Menu 

11.1  MGED  DATABASE  FILE 


Causes  a  copy  of  the  current  database  to  be  made.  The  user  is  prompted  for  a  file  name.  If  no  file 
name  is  given,  no  database  file  is  created. 

11.2  POSTSCRIPT  FILE 

Copies  the  current  display  into  a  postscript  file.  The  user  is  prompted  for  a  file  name.  If  no  file 
name  is  given,  no  postscript  file  is  created. 

11.3  PIX  FILE 

Ray  traces  the  current  display  and  puts  the  result  into  a  file.  The  user  is  prompted  for  a  file  name. 
If  no  file  name  is  given,  it  puts  the  result  into  a  frame  buffer.  The  user  is  also  given  the  opportunity 
to  change  the  default  rt  options. 

11.4  OPEN 

Open  another  database.  The  user  is  prompted  for  a  file  name.  If  no  file  name  is  given,  the  user  will 
be  prompted  to  create  a  new  database.  At  this  time,  if  the  user  refuses  to  create  a  new  database 
and  currently  no  database  is  open,  the  program  is  exited.  See  the  opendb  command. 

11.5  INSERT 

This  causes  another  database  to  be  inserted  into  the  current  database.  The  user  is  prompted  for  a 
file  name. 

11.6  SHOW  INFO 

Displays  the  solid/object  information  window. 

11.7  MANUAL 

This  executes  a  World  Wide  Web  (WWW)  browser  (Mosaic  by  default)  with  references  to  a  Uniform 
Resource  Locator  (URL)  that,  by  default,  points  to  the  MGED  manual  as  well  as  the  XMGED  doc¬ 
umentation.  The  browser  and  the  URL  both  have  X  resource  names  for  specifying  user  preferences. 
The  resource  names  are  browser  and  url,  respectively. 

11.8  EXIT 

Quit  XMGED. 

12  New  Environment  Variables 

12.1  MGED_JOURNAL 

This  defines  the  journal  file  that  is  written  to  when  journalling  is  active.  If  this  is  not  defined,  the 
file  named  mged, journal  is  created  in  the  current  directory. 

12.2  MGED^SRC_DIR 

This  defines  the  directory  that  is  searched  for  command  files  to  be  used  with  the  source  command. 
If  this  is  not  defined  or  the  command  file  is  not  found  in  this  directory,  the  current  directory  is 
searched.  If  the  command  file  is  still  not  found,  the  user^s  home  directory  is  searched. 


12.3  XMGEDRC 


This  defines  the  startup  file  that  is  read  in  during  the  initialization  process.  If  this  is  not  defined, 
or  the  startup  file  is  not  found,  the  current  directory  is  searched  for  the  file  .xmgedrc.  If  this  file  is 
not  found,  it  is  searched  for  in  the  home  directory. 

13  Future  Enhancements 

These  are  a  few  of  the  items  being  considered  for  the  future.  It  should  be  noted  that  all  of  the 
XMGED  features  are  subject  to  change  based  on  user  feedback  and  future  design  decisions. 

•  Allow  resize  of  main  window 

•  Provide  a  choice  between  using  the  Motif  or  Athena  widget  sets 

•  Command  line  editing  for  MGED  proper 

•  Consider  using  one  or  more  of  the  following: 

o  C+-f  and  Fresco 
o  Tcl/Tk 
o  Opengl 

•  Undo  command 

•  Dump/read  state  command 
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APPENDIX  A: 
STARTUP  DEFAULTS 
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A  Startup  Defaults 

The  following  is  a  list  of  the  startup  defaults  presented  in  the  format  of  an  XMGED  startup  file. 
See  the  Startup  File  section  for  a  description  of  the  startup  file  syntax. 

Keys 
“  { 


XK_o 

"press  reset" 

XK_i 

"aip  f" 

XK_I 

"aip  b" 

XK.p 

"M  1  0  0" 

XK_0 

"knob  zero" 

XK^x 

"iknob  X  .05" 

XK_y 

"iknob  y  .05" 

XK^z 

"iknob  z  .05" 

XK_u 

"iknob  X  .05" 

XK^v 

"iknob  Y  .05" 

XK_w 

"iknob  Z  .05" 

XK^X 

"iknob  X  -.05" 

XK^Y 

"iknob  y  -.05" 

XK.Z 

"iknob  z  -.05" 

XK.U 

"iknob  X  -.05" 

XK.V 

"iknob  Y  -.05" 

XK_W 

"iknob  Z  -.05" 

XK_f 

"press  front" 

XK_t 

"press  top" 

XK_b 

"press  bottom" 

XK_1 

"press  left" 

XK_r 

"press  right" 

XK_R 

"press  rear" 

XK.3 

"press  35,25" 

XK_4 

"press  45,45" 

XK.Up 

"irot  -2  0  0" 

XK.Down 

"irot  2  0  0" 

XK.Left 

"irot  0  -2  0" 

XK^Right 

"irot  0  2  0" 

XK^KP.Up 

"irot  “2  0  0" 

XK.KP.Down 

"irot  2  0  0" 

XK.KP.Left 

"irot  0  -2  0" 

XK.KP^Right 

"irot  0  2  0" 

XK.KP_End 

"irot  0  0  2" 

XK_KP_Next 

"irot  0  0  -2" 

XK.KP^Prior 

"zoom  1.005" 

XK.KP.Home 

"zoom  0.995" 

XK^Fl 

"cue" 

XK_F2 

"zclip" 

XK_F3 

"perspective" 

XK_F4 

"zbuffer" 

XK_F6 

"light" 

XK_F6 

"perspective  4" 

XK_5 

"iknob  distadc  5" 

XK_perceiit 

"iknob  distadc  -5 

XK_6 

"iknob  angl  10" 

XK.asciicircum 

"iknob  angl  -10" 

XK^7 

"iknob  ang2  10" 
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XK_ ampersand 

XK^8 

“iknob  ang2  -10 
‘•iknob  xadc  10” 

II 

XK.asterisk 

XK^9 

"iknob  xadc  -10 
"iknob  yadc  10" 

II 

XK^parenleft 

"iknob  yadc  -10 

ti 

XK.KP.l 

"itran  -0.01  0. 

0  0.0" 

XK_KP_2 

"itran  0.01  0.0 

0.0" 

XK^KP^4 

"itran  0.0  -0.01  0.0" 

XK_KP^5 

"itrcin  0.0  0.01 

0.0" 

XK^KP^r 

"itran  0.0  0.0  ■ 

-0.01" 

XK_KP^8 

"itran  0.0  0.0  < 

0.01" 

XK.a 

"button  173" 

#alternate  mouse  mode 

XK_A 

"button  170" 

#angle  distance  cursor 

XK^h 

"button  177" 

#help  menu 

XK^m 

"button  174" 

#multi  views  mode 

XK_s 

"button  183" 

#show  info  window 

XK^S 

"button  167" 

#sliders 

XK_underscore 

"set  v_axis=0" 

#view  axis  off 

XK_F7 

"set  v„axis=l" 

#view  axis  center 

XK^F8 

"set  v_axis=2" 

#view  axis  lower  left 

XK_F9 

"set  v_axis=3" 

#view  axis  upper  left 

XK.FIO 

"set  v_axis=4" 

#view  axis  upper  right 

XK.Fll 

"set  v_axis=5" 

#view  axis  lower  right 

XK^F12 

"set  v_axis=6" 

#view  axis  center  -  half 

XK_E 

"set  e_axis=0" 

#edit  axis  off 

XK^e 

"set  e_axis=l" 

#edit  axis  on 

XK.plus 

"set  w_axis=0" 

#world  axis  off 

XK_ equal 

"set  w_axis=l" 

#world  axis  on 

Buttons 

{ 


Buttonl 

View 

Out zoom 

Button2 

View 

Slew 

Button3 

View 

Inzoom 

Buttonl 

Alt 

Translate 

Button2 

Alt 

Rotate 

Buttons 

Alt 

Zoom 

Buttonl 

Swap 

Putview 

Button2 

Swap 

Swapview 

Buttons 

Swap 

Getview 

Buttonl 

Edit 

Out zoom 

Button2 

Edit 

Pick 

Buttons 

Edit 

Inzoom 

BBox 

{ 


Buttonl 

"button 

177" 

Button2 

"button 

170" 

Buttons 

"button 

166" 
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Buttoii4 

"button 

16S" 

Buttons 

"button 

142" 

Buttons 

"button 

147" 

ButtonT 

"button 

14S" 

Buttons 

"button 

149" 

Button9 

"button 

1S4" 

ButtonlO 

"button 

165" 

Buttonll 

"button 

143" 

Buttonl2 

"button 

144" 

ButtonlS 

"button 

145" 

Buttonl4 

"button 

146" 

ButtonlS 

"button 

174" 

But ton 16 

"button 

164" 

Butt on 17 

"button 

151" 

ButtonlS 

"button 

150" 

Buttonl9 

"button 

152" 

Button20 

"button 

163" 

Button21 

"button 

172" 

Button22 

"button 

171" 

Button23 

"button 

153" 

Button24 

"button 

157" 

Button25 

"button 

156" 

Button26 

"button 

161" 

Button27 

"button 

162" 

Button2S 

"button 

154" 

Button29 

"button 

156" 

ButtonSO 

"button 

160" 

ButtonSl 

"button 

159" 

Button32 

"button 

163" 

Dials 


DialO 

xjoy 

Diall 

xslew 

Dial2 

yjoy 

Dial3 

yslew 

Dial4 

2  joy 

Dial5 

zslew 

Dials 

none 

Dial7 

zoom 

DialO 

Shift 

adcx 

Diall 

Shift 

xslew 

Dial2 

Shift 

adcy 

Dial3 

Shift 

yslew 

Dial4 

Shift 

adc2 

Dials 

Shift 

adcDist 

Dials 

Shift 

add 

Dial7 

Shift 

zoom 

31 


Intentionally  left  blank. 


32 


APPENDIX  B: 
KEYSYM  LIST 
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B  Keysym  List 

This  section  contains  a  list  of  the  supported  keysyms  which  were  taken  from  the  keysymdef.h  header 
file  that  is  provided  with  the  XI 1  distribution.  The  keysyms  are  used  with  the  bindkey  command  and 
in  the  startup  file  for  specifying  key  bindings.  When  using  the  keysym  with  the  bindkey  command, 
the  preceding  XK^  is  not  used.  The  following  sections  of  the  header  file  are  contained  in  the  list 
below: 

•  Miscellany 

•  Japanese  keyboard  support 

•  Cursor  control  k  motion 

•  Misc  Functions 

•  Keypad  Functions 

•  Auxiliary  Functions 

•  Modifiers 

•  Latinl 


Supported  Keysyms 


XK_BackSpace 

XK_R1 

XK„j 

XK.Tab 

XK_F22 

XK_k 

XK_Linef eed 

XK^R2 

XK.l 

XK.Clear 

XK.F23 

XK_in 

XK.Return 

XK_R3 

XK_n 

XK_Pause 

XK.F24 

X 

X 

o 

XK.Scroll^Lock 

XK_R4 

XK.p 

XK_Sys3eq 

XK.F25 

XK_q 

XK_Escape 

XK^R5 

XK.r 

XK_Delete 

XK^F26 

XK„s 

XK_Multi_key 

XK.R6 

XK^t 

XK.Kanji 

XK_F27 

XK.u 

XK_Muhenkan 

XK_R7 

XK_v 

XK_Henkan_Mode 

XK^F28 

XK.w 

XK^Henkan 

XK^R8 

XK„x 

XK_Roma j i 

XK.F29 

XK_y 

XK.Hirageoia 

XK_R9 

XK_z 

XK_Katakana 

XK^F30 

XK.braceleft 

XK_Hiragana_KatcLkaiia 

XK.RIO 

XK.bar 

XK^Zenkaku 

XK_F31 

XK_braceright 

XK.Hankaku 

XK311 

XK^asciitilde 

XK  _  Z  enkaku^Hctnkciku 

XK_F32 

XK_nobr eakspac  e 

XK^Touroku 

XK^R12 

XK.exclamdown 

XK.Massyo 

XK_R13 

XK_cent 

XK_Kana„Lock 

XK_F33 

XK.sterling 

XK_KaLna„Shift 

XK^F34 

XK^currency 

XK.Eisu^Shilt 

XK_R14 

XK_yen 

XK_Eisu_toggle 

XK.F35 

XK_brokeiibar 

XK.Home 

XK_R15 

XK^section 

XK.Left 

XK.Shift.L 

XK_diaeresis 

XK.Up 

XK.Shift^R 

XK_ copyright 

XK^Right 

XK_Control_L 

XK^ordf eminine 

XK.Down 

XK_Control^R 

XK^guillemotleft 

XK.Prior 

XK_Caps_Lock 

XK^notsign 

XK^Next 

XK.Shilt^Lock 

XK^hyphen 

XK^End 

XK.Meta^L 

XK^registered 

XK.Begin 

XK_Meta_R 

XK^macron 

XK^Select 

XK_Alt_L 

XK^degree 

XK^Print 

XK_Alt_R 

XK^plusminus 

XK_Execute 

XK„Super„L 

XK.twosuperior 

XK^Insert 

XK_Super_R 

XK^threesuperior 

XK^Undo 

XK.Hyper^L 

XK.acute 

XK^Redo 

XK.Hyper.R 

XK.mu 

XK.Menu 

XK_space 

XK^paragraph 

XK^Find 

XK.exclam 

XK^periodcentered 

XK.Cancel 

XK_quotedbl 

XK.cedilla 

XK.Help 

XK.numbersigii 

XK.onesuperior 

XK.Break 

XK.dollar 

XK^masculine 

XK^Mode^switch 

XK_percent 

XK^guillemotright 

XK_script_switcli 

XK_ainpersaiid 

XK^onequarter 

XK_Num_Lock 

XK_apostrophe 

XK.onehalf 

XK_KP_Space 

XK_quoteright 

XK^threequarters 

XK_KP_Tab 

XK_parenleft 

XK.questiondown 

XK.KP^Enter 

XK.parenright 

XK^Agrave 

XK_KP_F1 

XK_asterisk 

XK.Aacute 

XK^KP_F2 

XK.plus 

XK^Acircumflex 

XK_KP_F3 

XK_ comma 

XK^Atilde 

XK_KP^F4 

XK_minus 

XK^Adiaeresis 

XK.KP.Home 

XK_period 

XK^Aring 

XK.KP^Left 

XK.slash 

XK^AE 

XK_KP„Up 

XK_0 

XK.Ccedilla 

XK_KP_Right 

XK_1 

XK^Egrave 

XK_KP_Down 

XK_2 

XK^Eacute 

XK.KP^Prior 

XK_3 

XK.Ecircumflex 

XK_KP_Next 

XK_4 

XK.Ediaeresis 

XK.KP^End 

XK_5 

XK^Igrave 

XK^KP.Begin 

XK_6 

XK^Iacute 

XK_KP_Insert 

XK_7 

XK^Icircumflex 

XK_KP_Delete 

XK_8 

XK^Idiaeresis 

XK.KP.Equal 

XK_9 

XK.ETH 

XK.KP.Multiply 

XK_colon 

XK.Eth 

XK^KP^Add 

XK_semicolon 

XK.Ntilde 

XK_KP_Separator 

XK.less 

XK^Ograve 

XK_KP„Subtract 

XK_ equal 

XK^Oacute 

XK_KP_Decimal 

XK_gr eater 

XK.Ocircumllex 

XK_KP_Divide 

XK_question 

XK.Otilde 

XK_KP_0 

XK.at 

XK^Odiaeresis 

XK.KP^l 

XK.A 

XK_mult iply 

XK_KP_2 

XK_B 

XK^Ooblique 

XK_KP_3 

XK„C 

XK^Ugrave 

XK^KP.4 

XK.D 

XK^Uacute 

XK_KP„5 

XK_E 

XK_Ucircumflex 

XK_KP^6 

XK_F 

XK^Udiaeresis 

XK^KP.T 

XK_G 

XK^Yacute 

XK_KP_8 

XK.H 

XK.THORN 

XK^KP.9 

XK.I 

XK^Thorn 
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XK^Fl 

XK^J 

XK_s sharp 

XK.F2 

XK^K 

XK_agrave 

XK^F3 

XK.L 

XK_aacute 

XK^F4 

XK.H 

XK^acircumflex 

XK^F5 

XK^N 

XK^atilde 

XK^F6 

XK_0 

XK^adiaeresis 

XK^FT 

XK.P 

XK_aring 

XK.F8 

XK_Q 

XK.ae 

XK^F9 

XK_R 

XK.ccedilla 

XK^FIO 

XK_S 

XK_egrave 

XK^Fll 

XK_T 

XK_eacute 

XK.Ll 

XK_U 

XK.ecircumflex 

XK^F12 

XK^V 

XK^ediaeresis 

XK^L2 

XK_W 

XK_igrave 

XK,F13 

XK_X 

XK_iacute 

XK.L3 

XK.Y 

XK^icircuinflex 

XK.F14 

XK.Z 

XK^idiaeresis 

XK^L4 

XK.bracketleft 

XK„eth 

XK.F15 

XK_backslash 

XK_ntilde 

XK^L5 

XK.bracketright 

XK_ograve 

XK^Fie 

XK.asciicircam 

XK_oaciite 

XK,L6 

XK.underscore 

XK.ocircumflex 

XK.F17 

XK^grave 

XK_otilde 

XK^L7 

XK_quoteleft 

XK_odiaeresis 

XK^FIS 

XK_a 

XK^division 

XK.L8 

XK_b 

XK.oslash 

XK^F19 

o 

1 

X 

XK_ugrave 

XK.L9 

XK.d 

XK_uacute 

XK.F20 

XK_e 

XK.ucircumflex 

XK.LIO 

XK_f 

XK_udiaeresis 

XK,F21 

XK_g 

XK_y acute 

XK_ii 

XK_thorn 

XK.i 

XK_ydiaeresis 
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APPENDIX  C: 


SAMPLE  SOURCE  FILE 
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C  Sample  Source  File 

The  following  commands  set  up  the  aliases  necessary  to  build  the  tin  woodsman  simply  by  typing 
buildwoody.  These  kinds  of  commands  can  be  stored  in  a  file  and  read  into  XMGED  using  the 
source  command. 

alias  woodytitle  title  A  Tin  Woodsman 

alias  hat  in  $1  rcc  0002001;  sed  $1;  press  srot;  p  0  45  90;\ 
press  tgc.scd;  p  .1;  press  strein;  p  0  2,2  0;  press  accept;\ 
cp  $1  $2;  sed  $2;  press  tgc^sab;  p  .1;  press  stran;\ 
p  0  4.2  0;  press  accept 

alias  torso  in  $1  rpp  -11-11-11;  sed  $1;  extrude  2367  3;\ 
press  accept 

alias  head  in  $1  sph  0201 

alias  collar  in  $1  tor  0000101  .2;  sed  $1;  press  tor^sr2;\ 
p  .1;  press  stran;  p  0  1  0;  press  accept 
alias  arm  in  $1  ellg  000  10  00  0.50  00  0.5;  sed  $1;\ 

press  srot;  p  0  45  90;  press  ell_sb;  p  .25;  press  ell_sc;\ 
p  .25;  press  accept 

alias  leg  in  $1  ellg  00010000. 50000. 5;  sed  $1;  press  srot;\ 
p  0  45  90;  press  accept 

alias  l_arm  arm  l_uarm;  sed  l^uarm;  press  stran;  p  -1.3  0  0;\ 

press  accept;  cp  l_uarm  l^larm;  sed  l„larm;  press  stran; \ 
p  -1.3  -2  0;  press  accept 

alias  r_arm  arm  r_uarm;  sed  r.uarm;  press  stran;  p  1.3  0  0; 

press  accept;  cp  r_uarm  r_larm;  sed  r^larm;  press  stran ;\ 
p  1.3  -2  0;  press  accept 

alias  l_leg  leg  l_uleg;  sed  l_uleg;  press  stran;  p  -0.5  -3  0;\ 

press  accept;  cp  l_uleg  l_lleg;  sed  l_lleg;  press  stran; \ 
p  -0.5  -5  0;  press  accept 

alias  r_leg  leg  r.uleg;  sed  r^uleg;  press  stran;  p  0.5  -3  0;\ 

press  accept;  cp  r.uleg  r^lleg;  sed  r.lleg;  press  stran ;\ 
p  0.5  -5  0;  press  accept 
alias  rtorso  r  $1  u  $2 

alias  rlimbs  r  limbs. r  u  l_uarm  u  l.larm  u  r_uarm  u  r.larm  u  l_uleg\ 
u  l„lleg  u  r.uleg  u  r_lleg 
alias  rhat  r  $1  u  $2  -  $3  u  $4  -  $2 
alias  r collar  r  $1  u  $2 
alias  rhead  r  $1  u  $2 

alias  createlimbs  l_arm;  r^arm;  l_leg;  r_leg; 
alias  materhat  mater  $1  plastic  sh=100  35  107  142  0 
alias  matertorso  mater  $1  plastic  sh=10  95  159  159  0 
alias  materlimbs  mater  $1  plastic  sh=10  255  127  0  0 
alias  matercollar  mater  $1  plastic  sh=100  255  200  160  0 
alias  materhead  mater  $1  plastic  sh=100  200  120  60  0 
alias  gman  g  man.g  hat.r  noggin. r  collar. r  body.r  limbs. r 
alias  buildwoody  woodytitle;  hat  hat  hattop;  torso  body;\ 
head  noggin;  createlimbs;  collar  collar ;\ 
rhead  noggin. r  noggin;  rtorso  body.r  body;  rlimbs ;\ 
rcollar  collar. r  collar;  rhat  hat.r  hat  collar  hattop ;\ 
materhat  hat.r;  matertorso  body.r;  matercollar  collar.r;\ 
materlimbs  limbs. r;  materhead  noggin. r;  gman 
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Intentionally  left  blank. 
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APPENDIX  D: 
XI 1  RESOURCES 
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INTENTIONALLY  LEFT  BLANK. 


D  XI 1  Resources 

D.l  Resource  Names 


You  may  wish  to  install  the  XMged  resources  file,  or  at  least  examine  it  to  see  about  modifying 
things  to  taste.  You  can  also  set  the  environment  variable  XENVIRONMENT  to  the  name  of  the 
file  where  your  preferred  resources  are  stored. 

The  resource  names  for  the  buttons  are  identical  to  the  button  descriptions  as  listed  for  the 
button  command  in  section  8.4  except  that  the  spaces  are  replaced  by  underscores.  The  resource 
names  for  the  sliders  and  the  help  list  buttons  are  the  same  as  their  respective  labels.  The  remainder 
of  the  pertinent  resource  names  are  listed  in  Table  D-1.  Table  D-2  lists  the  widget  classes  used  in 
the  implementation. 


Table  D-1:  X  Resources 


Description 

Resource  Name 

command  window 

text 

drawing  window 

draw 

input  window 

input_win 

viewl  window 

viewl 

view2  window 

view2 

view3  window 

view3 

view4  window 

view4 

screen  info  window 

screen-info 

info  window 

info 

info  scroll  window 

infojscroll 

help  scroll  window 

help-scroll 

help  list  form 

help -form 

help  list  window 

helpJist 

help  text  window 

help-text 

pane  window 

pane 

menu  bar 

menu-bar 

main  menu 

mainanenu 

top  level  form 

top -form 

open  fsb  (file  selection  box) 

Open-Fsb 

insert  fsb 

Insert-Fsb 

save  postscript  fsb 

Save-Ps-Fsb 

save  database  fsb 

Save-Db_Fsb 

save  pix  fsb 

Save-Pix-Fsb 

rt  option  text 

Rt-Option_Text 

rt  option  label 

Rt-OptionJLabel 

WWW  browser 

browser 

uniform  resource  locator 

url 

world  axis  color 

w-axis 

view  axis  color 

v-axis 

edit  axis  color 

e-axis 
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Table  D-2:  X  Classes 


Widget  Classes  Used 

CascadeButton 

PushButton 

ToggleButton 

Text 

PanedWindow 

Form 

RowColumn 

Separator 

ScrolledWindow 

FileSelectionBox 


D.2  Fallback  Resources 

This  is  a  list  of  the  fallback  resources,  i.e.,  the  resources  that  are  used  if  they  are  not  explicitly  set 
elsewhere. 

XMged+fontList :  fixed 
XMged*Rt_Optioii_Text .  value :  "S512 
XMged*draw . background :  black 
XMged*draw . f or eground :  white 
XMged*pattern:  *.g 
XMged*Save„Ps_Fsb*pattern:  ♦.ps 
XMged*Save_Pix_Fsb*patt ern :  ♦ .  pix 
XHged*shadowThickness ;  2 
XMged*button_container*marginHeight :  4 
XMged*button_container*marginWidth :  4 
XMged*input_win. background:  black 
XMged*input .win. width:  400 
XMged*input_win.height :  400 
XMged+help.list . orientation:  HORIZONTAL 
XMged*help_list . packing :  PACK.COLUMN 
XMged*help.list . numColumns :  22 
XMged*text .rows :  2 
XMged*help_text . rows :  10 
XMged*help.t ext . columns :  80 
XMged*keyboardFocusPolicy :  POINTER 
XMged*scales*f rame . shadowThickness :  6 
XMged*main_menu*shadowThickness :  2 
XMged*separatorl*shadowThickness :  4 
XMged*separator2*shadowThickness :  4 
XMged*separator3*shadowThickness :  4 
XMged*separatorl*margin:  4 
XMged*separator2*margin:  4 
XMged*separator3*margin:  4 
XMged*separatorl*height :  10 
XMged*separator2*height :  10 
XMged*separator3*height :  10 
XMged*help.scroll. width:  800 
XMged+help.scroll . height :  200 
XMged*info.scroll. width:  300 
XMged*inf o.scroll . height :  200 
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XMged*info*backgroiind:  black 
XMged*info*foregroTind:  white 
XMged*info. width:  800 
XMged+inf ©.height:  800 
XMged*screen_inf o*height :  40 

XMged*URL :  http : / / admii . arl . army . mil/"bparker/mged/all . html 

XMged*browser :  Mosaic 

XMged*w_axis :  yellow 

XMged*v_axis :  cyan 

XMged*e_axis :  magenta 


47 


Intentionally  left  blank. 
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NO.  OF 

COPIES  ORGANIZATION 

2  ADMINISTRATOR 

DEFENSE  TECHNICAL  INFO  CTR 
ATTN  DTIC  DDA 
CAMERON  STATION 
ALEXANDRIA  VA  22304-6145 

1  DIRECTOR 

US  ARMY  RESEARCH  LAB 
ATTN  AMSRL  OP  SD  TA 
2800  POWDER  MILL  RD 
ADELPHI  MD  20783-1145 

3  DIRECTOR 

US  ARMY  RESEARCH  LAB 
ATTN  AMSRL  OP  SD  TL 
2800  POWDER  MILL  RD 
ADELPHI  MD  20783-1145 

1  DIRECTOR 

US  ARMY  RESEARCH  LAB 
ATTN  AMSRL  OP  SD  TP 
2800  POWDER  MILL  RD 
ADELPHI  MD  20783-1145 


ABERDEEN  PROVING  GROUND 

5  DIR  USARL 

ATTN  AMSRL  OP  AP  L  (305) 
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NO.  OF 

COPIES  ORGANIZATION 


ABERDEEN  PROVING  GROUND 

9  DIR  USARL 

ATTN:  AMSRL-SC, 

WILLIAM  H.  MERMAGEN 
AMSRL-SC-CC  (4  CP) 
AMSRL-SL-BV  (4  CP) 
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USER  EVALUATION  SHEET/CHANGE  OF  ADDRESS 


This  Laboratory  undertakes  a  continuing  effort  to  improve  the  quality  of  the  reports  it  publishes.  Your  comments/answers 
to  the  items/questions  below  will  aid  us  in  our  efforts. 

1.  ARL  Report  Number  ARL-TR-868 _ Date  of  Report  September  1995 _ 

2.  Date  Report  Received _ _ _ 

3.  Does  this  report  satisfy  a  need?  (Comment  on  purpose,  related  project,  or  other  area  of  interest  for  which  the  report 

will  be  used.) _ _ _ 


4.  Specifically,  how  is  the  report  being  used?  (Information  source,  design  data,  procedure,  source  of  ideas,  etc.) 


5.  Has  the  information  in  this  report  led  to  any  quantitative  savings  as  far  as  man-hours  or  dollars  saved,  operating  costs 
avoided,  or  efficiencies  achieved,  etc?  If  so,  please  elaborate. _ 


6.  General  Comments.  What  do  you  think  should  be  changed  to  improve  future  reports?  (Indicate  changes  to 
organization,  technical  content,  format,  etc.) _ 


Organization 


CURRENT  Name 

ADDRESS  _ 

Street  or  P.O.  Box  No. 


City,  State,  Zip  Code 

7.  If  indicating  a  Change  of  Address  or  Address  Correction,  please  provide  the  Current  or  Correct  address  above  and  the 
Old  or  Incorrect  address  below. 


Organization 


OLD  Name 

ADDRESS  _ 

Street  or  P.O.  Box  No. 


City,  State,  Zip  Code 

(Remove  this  sheet,  fold  as  indicated,  tape  closed,  and  mail.) 
(DO  NOT  STAPLE) 


